QuickTime 4 API Documentation

3D Graphics Programming with QuickDraw 3D 1.5.4

Previous | QD3D Book | Overview | Chapter Contents | Next |

Creating Groups

QuickDraw 3D provides a number of routines for creating group objects.

Q3Group_New

You can use the Q3Group_New function to create a new group.

TQ3GroupObject Q3Group_New (void);

DESCRIPTION

The Q3Group_New function returns, as its function result, a new group. The new group is initially empty. If an error occurs, Q3Group_New returns NULL .

ERRORS

kQ3ErrorOutOfMemory

Q3LightGroup_New

You can use the Q3LightGroup_New function to create a new light group.

TQ3GroupObject Q3LightGroup_New (void);

DESCRIPTION

The Q3LightGroup_New function returns, as its function result, a new light group. The new group is initially empty. If an error occurs, Q3LightGroup_New returns NULL .

See the chapter "Light Objects" in this book for information on creating and manipulating individual lights.

ERRORS

kQ3ErrorOutOfMemory

Q3DisplayGroup_New

You can use the Q3DisplayGroup_New function to create a new display group.

TQ3GroupObject Q3DisplayGroup_New (void);

DESCRIPTION

The Q3DisplayGroup_New function returns, as its function result, a new display group. The new group is initially empty. If an error occurs, Q3DisplayGroup_New returns NULL .

ERRORS

kQ3ErrorOutOfMemory

Q3InfoGroup_New

You can use the Q3InfoGroup_New function to create a new information group.

TQ3GroupObject Q3InfoGroup_New (void);

DESCRIPTION

The Q3InfoGroup_New function returns, as its function result, a new information group. The new group is initially empty. If an error occurs, Q3InfoGroup_New returns NULL .

ERRORS

kQ3ErrorOutOfMemory

Q3OrderedDisplayGroup_New

You can use the Q3OrderedDisplayGroup_New function to create a new ordered display group.

TQ3GroupObject Q3OrderedDisplayGroup_New (void);

DESCRIPTION

The Q3OrderedDisplayGroup_New function returns, as its function result, a new ordered display group. The new group is initially empty. If an error occurs, Q3OrderedDisplayGroup_New returns NULL .

ERRORS

kQ3ErrorOutOfMemory

Q3IOProxyDisplayGroup_New

You can use the Q3IOProxyDisplayGroup_New function to create a new I/O proxy display group.

TQ3GroupObject Q3IOProxyDisplayGroup_New (void);

DESCRIPTION

The Q3IOProxyDisplayGroup_New function returns, as its function result, a new I/O proxy display group. The new group is initially empty. If an error occurs, Q3IOProxyDisplayGroup_New returns NULL .

ERRORS

kQ3ErrorOutOfMemory


© 1997 Apple Computer, Inc.

Previous | QD3D Book | Overview | Chapter Contents | Next |